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\NO\N, 40+ new commands for beta 
testing and some serious demos 
including documented source code! 
Wiio cares if it's 6 weeks late? 




(SIKUM 
Winm (WIFIFII€IK.. 

More gossip from the St Kevins Arcade office of Acid 
Software Si Vision Software... 

Up in St Kevins Arcade things have been as crazy as ever. 
Vision Software are looking to blow everyone out with Seek 
and Destroy a game which I can say makes another 
helicopter game released this year look like a heli-tour of 
Wimbledon common. 

SkidMarks is shaping up well with Andrew spending even 
more time at the office than up at Auckland University 
where he's supposedly a full time student. Our raytracing 
efforts are looking really nice, the packaging is pretty much 
sussed and it's now time to finish the 1 2 tracks promised for 
final release. Wo, wouldn't it be nice for the first Blitz2 
commercial game to hit the top ten? 

The CD32 has arrived and has been fully tested with the 
entire CD collection (music that is). The controller is 
awesome with no less than 7 buttons plus joypad and the 
buster chip is going to get one hell of a workout over the 
next few weeks. 

Favourite CD of the month goes to Shihad's CHURN, a 
local kiwi group which we all hope are going to kick some 
butt overseas. 

Speaking of kicking butt. Blitz User's should look out for 
Amiga Format issues 51 and 52. With this sort of exposure 
we're hoping to pronounce a certain A**S PRO and 
accompanying compiler out of contention for Amiga 
language sales this XMas. However we need PD material 
to keep the reputation alive so come on everyone, anything 
will do as long as it's different! 
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Back in the office... 2 

Latest gossip from the kiwi crew. 

Editorial 4 

From the Minister of Finance, programming 
and Export affairs comes the current state of 
the Acid nation. 

Programming a Commodity 5 

Thomas Boerkel outlines 
programming a Commodity in Blitz2 




Roger's Beginners Column 7 

Roger delves intp number systems 
for beginners and Simon adds a 
cheats chart which he thinks 
everyone should learn off by heart. 

NEW COMMANDS 

Some 50 new commands for Blitz2 
programmers 

Windows Library Additions 1 1 

Gadgets Library Additions 13 

Screens Library Additions 14 

Palette Library Additions 15 

Misc New Commands 16 

DISPLAY LIBRARY 17 

ASL LIBRARY 19 

GADTOOLS LIBRARY 21 
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Yo BlitzUsers! Well BUMS is 
late, veiy late! Sorry, even now 
most of the new commands 
havenU got full error checking 
and the docs are a little rough. 
We*ll just call this a beta 
testing issue so don't go getting 
upset cos things don't work 
properly. Just calmly fill out a 
bug report and send/fax/post it 
my way. 

OK so what do you get to test? 
The new display library is 
coming together nicely, it's a 
bit different than how slices 
work but an improvement I 
think overall. If you have not 
already got it together with 
slices I'd wait for better 
documentation before having a 
crack with the new display 
commands. 

For applications development 
there is new support for both 
GadTools and ASL requesters. 
It seems pretty stable at present 
but once again these new 
commands are still in the beta- 
test catagory. 

It's been enjoyable work 
adding all the extra stuff and 
hopefully you'll be able to use 
it to create some decent 
software. Although we don't 
demand that Blitz2 be 
mentioned on any releases 
developed with it we would 
appreciate the publicity. It is in 
everyone's interest that Blitz2 
sells well and Acid Software 
keeps paying it's bills so go on 
give us a credit in your next 
PD/commercial release. 

Speaking of paying the bills, 
our best wishes go out to 
Commodore leading up to 
Christmas. If they pull through 
the next few months by 
shipping megatons of AGA 
machines the new year could 
offer us all some real 




opportunities for creative 
projects. 

The best news of course is 
CD32, we'll be releasing ACID 
1 before XMas which will 
include an awesome AGA 
version of SkidMarks, 
Defender (the controllers come 
with 6 buttons!!!) Insectoids2 
and more. This confirms of 
course the existance of a 
complete set of CD32 
developer commands for 
Blitz2. These with a special 
cable, HD CD emulation 
drivers and our special bootCD 
will mean Blitz2 might well 
indeed be responsible for the 
biggest revolution in CD 
development tools ever. Hell, 
we might even charge a royalty 
of US$3 per disk too (just 
kidding). 

Other future enhancements for 
Blitz2 include Oopsi support 
(slowly working my way 
through my RKM :), a linker, 
another hack at a 3D 
environment, superbitmap 
windows, a new Intuitools 
program, hmmm better stop... 

A big hi goes out to the 
AcidSoftware master 
distributors, we're slowly 
developing a cohesive world 
wide marketing plan for BB2, 



at present we have on board: 

Germany: Tom AFalk 
phone 02217710922 fax=0940 

UK: Benoit Varasse 
phone/fax 071 482 4066 

OZ: Roy Hurley 
phone/fax 042 28 1489 

USA: Dave Maziaika 
phone 608 257 9057 

Once we start shipping decent 
quantities per month in each 
region we will be helping to get 
BUGS started (Blitz User 
Groups). The BUGs will take 
over most of the support 
including BBS support and 
distribution of BUMs (Blitz 
User Magazines). Keeping with 
the spirit of things I would also 
hope that BUGs can operate as 
PD Libraries and also gather 
contributions for BUMs. Each 
BUG will get 2 pages in future 
BUMs and we'll get some 
competitions between BUGs 
going to get everyone fired up. 

Anyway, I'll get BUM6 out 
before XMas so everyone 
knows what's happening for 
1994, promise! 

SIMON 
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What is a Commodity? 

Before AmigaOS 2.0, you had to write your own 
custom input handler and "link" it to the input.device 
if you wanted to react on several input-events. 
Sometimes this method caused problems when 
many programs created such handlers. There also 
was a lack of transparency and control for the user. 
Starting with AmigaOS 2.0, Commodore created a 
standard for programs which act on input-events. 

The new commodities. library controls all those 
programs (called "Commodities") and helps the 
programmer with several useful functions. The 
control-program "Exchange", which can be found in 
your Workbench 2.x/3.x:Tools/Commodities drawer, 
shows all running Commodities and information 
about them. The user can enable/disable a 
Commodity, force it to open/close its window and 
temiinate it. 

Almost all programs which act on input-events can 
be implemented as a Commodity. Input-events are 
keystrokes, mousemoves, mouseclicks and some 
other ones that are less important. Some examples 
for programs which can and should be implemented 
as a Commodity are: Keytranslators, program- 
launchers (for example Shell-popup), 
mouseblankers, screenblankers, screen/window- 
tools... 

Wl%al a Commodity has to do: 

Commodities should have the following tooltypes: 

CX_PRIORITY=x 

CX_POPUP=YES|NO 

CX_POPKEY=keystroke 
The last two only apply to Commodities that can 
open a window. 

Commodities have to react on messages from 
Exchange. If the user tries to start the Commodity 
again (while it is already running), the new started 
should shutdown itself immediatly. The already 
running one will receive a "UNIQUE"-message and 
should then do something, normally it will popup its 
window. Commodities should be as small as 
possible because they stay always in memory. They 
should only act on input-events of their interest to 



by Thomas Boerkel 

keep CPU-usage small. One exceptional type of 
Commodity is a screenblanker. This one is 
interested in all kinds of input-evenls. 

How to program a CommotUty 

To program a Commodity, you have to install 
some objects. The main object is called 
"Broker". This object is linked to the 
Commodities-handler which is linked in the 
input-stream. The Broker must have a message- 
port, where it gets messages from Exchange and the 
commodities. library. Other objects are: 

Fllt«rObJectt:filter inputeventsof your chobe 
S«nderOb|«cts:send messages to ports 
Translat«Ob|ectt:tran8late/modify events. 
CustomObi«cts:all other kinds of objects. 

Messages from Exchange have to be sorted out and 
the required action has to be taken. 

/. Test Commodity With popup-window 
•> Translator 
/ 
Broker -> Filter -> 

\ 

-> Sender 

The Broker sends all input-events to the Filter. The 
Filter sorts out one special keystroke and gives it to 
the Translator, which translates it to nothing (input- 
event is eliminated). The Filter also activates the 
Sender, which sends a message to a specific 
message-port. This can be and is often the same as 
the Brokers port. The filtering, translating and sending 
is done by the commodities.library without the need 
for the Commodity to do something. Actually the 
Commodity sleeps until the Sender sends it the 
message. Then it performs its action, in this example 
pops up its wirKk>w. 

2 Mousablanker with config-window. 
-> Translator 
/ 
Broker -> Filter 1 -> 



I 



•> Sender 1 



->Fmer2-> Sender 2 
Filter 1/Sender 1/Translator do the same as in 
Example 1 . They inform the Commodity when it has to 
open its window and kill the input-event (keystroke) 
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from the inputstream. Fitter 2 activates Sender 2 on 
mousemoves. Sender 2 sends a message to the 
Commodity, which then triggers its timer for 
mouseblanking. 

3. Funtion-Key program with config-window 
-> Translator 
/ 
Broker -> Filter 1 -> 



I 



-> Sender 1 



I -> Filter for "F1" -> Translator for "F1" 
I -> Filter for "F2" -> Translator for "F2" 
I -> Filter for "FS" -> Translator for "F3" 
Filter 1/Sender 1/Translator do the same as in 
Example 1. They inform the Commodity when it has 
to open its window and kill the input-event 
(keystroke) from the inputstream. For each F-key is a 
Fitter and a Translator irwtatled. The Fitter activates 
the Translator if the specific key is pressed. The 
Translator translates the keystroke to a series of 
input-events (keystrokes). So pressing "F1" could 
bring out the string "Dir" or something like that. 
Please note that the Translator needs a nunf4)er of 
chained input-events in reverBal(i) order. There is a 
comfortable function in Amiga. lib "InvertStringO" 
whk;h could do this, if tt couM be used in BIHz2. But 
unfortunately this isnt possible in the current versk>n 
of BtUzBasic so you have to tnjild your own chain of 
input-events. 

4. Screenblankw ■»■ config-window -*■ bianld^ey 

-> Translator 1 

/ 
Broker -> Filter 1-> 



•> Sender 1 



-> Translator 2 



-> Filter 2 -> 
\ 



-> Sender 2 



-> Sender 3 
Filter 1 /Sender 1/Translator 1 do the same as in 
Example 1. They inform the Commodity when it has 
to open its window and kill the input-event 
(keystroke) from the inputstream. Filter 2/Sender 
2/Translator 2 are necessary for the blankkey. If the 
blanker gets a message from Sender 2 it has to 
blank at once. Sender 3 is directly connected to the 
Broker. This means that tt sends a message to the 
port for every input-event, because a screenblanker 
is interested in almost every kind of input-event. The 
screenblanker has to select which action to do on 
which input-event. Normatty only screenblankers 
have to look after every input-event. Ail other 
Commodities usuaHy are only interested in special 



input-events. So the blanker can receive messages at 
the Brokers message-port from ail 3 senders and from 
Exchange. 

Sourc99 

On the BUMS coverdisk you shouki find the documented 
sources to BIttzBlank (f i4l-featured screenblanker) and 
TestComm (simply a test wtth popup-window and key- 
translatk>n for the Fl-key). 

Parts of special interest in BIttzBlanks source: 

WB-atartup-handlIng: BlitzBlank does not use 
'V/BStartup*. but does tts own WB-startup-handling to 
be able to get its tooltypes. Look at the start of 
BlitzBlank to see how the WBMessage is got. and at the 
end of the main program to see what a program with its 
own wb-start-handling has to do at the end (hey, Simon, 
what about getting tooltypes with Blitz-commands?). 

Getting the tooltypes: At the start of BlitzBlank. tt gets 
its tooltypes with FincfTooTTypes 0- 

Screenmoderequester: The included procedure 
"Screenreq" gets the possible screenmodes from your 
machine and displays a screenmoderequester with 
GadTools-gadgets. It uses the global long variables 
"modeid*. -wWlh", "height", "depth". 

QadTools-GUI: BlitzBlanks window is full of different 
kinds of GadTools-gadgets. Look at the subroutines 
■winon" and "gadgets" to see how that works. Preparing 
an image for a GadTools-gadget: The drawer-gadget's 
image is prepared in the si^rouline "doimagedata" and 
freed in "fieeimagedata". 

Writing tooltypes to Icon: BlitzBlank is able to set its 
own tooltypes with the current settings if the user clicks 
on the SAVE-gadget. Look at the subroutine "writett" 
which does this. 

Using the ASL-fHerequester: BlitzBlank displays the 
ASL-fHerequester when the user presses <HELP> in the 
path-gadget or clicks on the drawer-gadget. The 
requester is displayed with the subroutine "aslfilereq". 

Using EasyRequesters: In certain cases. BlitzBlank 
displays an EasyRequest. This is done in the subroutine 
"requester". 

Reading and writing conflg-data: The subroutines 
"readconfig" and "writeconfig" handle the 
"BB.modules.config" file. These are just the same 
routines as in the modules, but in BlitzBlank theyre done 
with OS-routines. 

Setting up the Commodity: The subroutine 
"docommair sets/resets the Commodity-objects. 

Killing the Commodltys objects: The subroutine 
"kWcomm" deletes all Commodity-objects. 

Finding the available modules: The subroutine 
"findmodules" searches wtth MatchNext() from DOSASL 
in the module-directory. 

Handling an exec.llbrary-llst: An exec-list is needed 
for the List View-gadget of modules. The subroutines 
"inttlist", "addallnodes" and "freeallnodes" handle this 

yst. 
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Hi again and welconne to the second of the 
beginners tutorials, this issue we will be 
covering NUMBER SYSTEMS 

Firstly, I'm gonna take some of the rap for the 
lateness of BUM #5 I've been a trifle lazy 
getting my stuff in to Simon, so sorry folks, 
still better late than never 

This topic NUMBER SYSTEMS is actuallv 
quite advanced and you'll find many a BASIC 
programmer who has no concept of them 
whatsoever, however as with last month if you 
want to REALLY understand programming, 
you'll want to know these so ONWARD 

(1) WHAT A COMPUTER IS, HOW 
COMPUTERS COUNT, WHAT MEMORY IS 
AND WHAT NUMBER SYSTEMS WE 
CONVERSE WITH A COMPUTER IN. 

Phew.... Few techle words in that title eh? I 
have never seen a programming article that 
covers these topics first which is a pity as 
unless you understand how computers store 
information and how to retrieve and 
manipulate it then you wont ever FULLY 
understand programming. 

What a computer is: 

A computer is a collection of millions of 
interconnected switches, these combinations 
of switches can do all sorts of flash things but 
the fundemental of ALL computers, from 
calculators to main-frames is that they only 
understand 2 things. ON and OFF 

So basically this mega-expensive machine 
you shelled out on is no more advanced than 
the light switch across the room, were alt the 
tricky things you can do with a computer 
comes in with the fact that a computer can 
switch things FAST and in different 
combinations. However from a programmers 
point of view we need a convenient way to 
describe weather something is ON or OFF 
and the simplest way is to use the number 1 
for ON and for off 



1 = 0N 
= OFF 

This is called the Binary number system 

The number system we use In everyday life is 
the DECIMAL number system (base 10), this 
system is used as we have 10 fingers and Its 
those we used to count with, however to 
understand the basics of programming we 
need to learn BINARY (base 2) DECIMAL 
(base 10) we already know and 
HEXADECIMAL (base 16) 

Whats a binary number? 

Well to start you thinking heres a table with 
Binary numbers on the left and their decimal 
equivilents on the right from to 10: 



DEC 


BIN 





0000 


1 


0001 


2 


0010 


3 


0011 


4 


0100 


5 


0101 


6 


0110 


7 


0111 


8 


1000 


9 


1001 


10 


1010 



Pretty Bizzarre huh? Well at least it looks that 
way until I tell you that alt you have to do to be 
able to do Decimal/binary conversion is to add 
numbers and double numbers! ie: 



32 


16 


|8| 


4 


|2 


1 


Decimal numbers 


1 





Ml 


1 


|0 


1 


Binary Number 



Ok so lets examine that table: 

First thing to note is that the '%' character in 
front of the binary number Is just how 
programmers specify that the digit Is in binary 
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ie: 10 is the number 10 in decimal 
%10 is the number 2 in decimal 

Ok now lets go back to the table, remember 
I told you all you had to do was be able to 
add and double well heres why, the top 
level of the table starts at the right at 1 and 
doubles (or goes to the power of 2) at each 
step to the left ie: 



250= 1 28+64+32+ 1 6+8+2 



1 = 


1 


1*2 = 


2 


2*2 = 


4 


4*2 = 


8 


8*2 = 


16 


16*2 = 


32 etc etc etc 



Right, so that covers the doubling, now the 
next level down is the binary number. As 
you can see the little holes below the 
decimal numbers either have a 1 (ON) or 
(OFF) in them. If the holes are ON then that 
means the decimal figure above is part of 
the resulting decimal number if the hole is 
OFF then it Isn't so in the above example 

%101101 = In decimal 
32+8+4+1 = 45 decimal 

Ok so draw yourself a copy of table 2 and 
using the knowledge you now have calulate 
the binary numbers for: 
a) 32 b)13 c)24 d) 5 e) 64 

If you have any problems just read through 
the example again until it 'clicks' 

Ok. if you have done your sums (just like 

your back at school) then these are the 

answers 

a)%100000 b)%1101 c)%11000 

d)%101 e)%111111 

Ok. now if we extended that table by 
doubleing our decimals you can see that by 
each position we add to the left doubles the 
maximum possible value we can represent 

ADVANCED: This question is designed to 
get you guys really thinking for yourselves, I 
want you to try and work out the number 
250 in binary, using common sense and the 
information above you hopefully will be able 
to do it. 

ANSWER: You had to create more 
columns, you had to create eight columns 
so the answer looked like this: 



128 

1 


64 

1 


32 
1 


16 

1 


8 
1 


4 



2 
1 


1 




so 250=%1 111 1010 

Right, so you can see so you can work out 
any number in binary, after a while you will 
be able to work out quite a few binary 
numbers in your head so keep practising, 
until you can do it mentally, check it using 
tables. 

Ok now work out 32987928437098274 in 
Binary - Just kidding 

HEXADECIMAL 

Now the only other number system you 
need to know is Hexadecimal. As discussed 
before binary is Base 2 Decimal is Base 10 
and Hexadecimal is Base 16 (ie Decimal + 
Hexa) Most of you will know that Hex 
means 6 so 10+6= 16. 

It's at this point that we come to a rather 
interesting problem, thus far we have only 
had to represent number systems with a 
base lower than 10 now that we have a 
base above 10 we need to invent some new 
number symbols and here they are 

A =10 
B =11 
C =12 
D =13 
E =14 
F =15 

So there it is Hex values range from to F 
and just as we proceeded a binary number 
with a '%' sign, we proceed a hex number 
with a '$' sign. Here are some Hex 
numbers: $1FAB, $FF, $FACE, $234DE 

So how do we translate from decimal to hex 
and vica versa well the way I do it involves 
converting the number to binary inbetween. 

PROB: To translate the number 182 in 
decimal to its hexidecimal value 

ANSWER: Firstly convert 182 to Binary 
(%1 01 101 10), then we convert from Binary 
to Hex. The important part to understand 
here is that hex (base 16) can represent the 
numbers to 15 before you hav^ to do a 
carry over to the next column. 
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The next bit to realise is that we can represent 
the numbers to 15 in binary in 4 bits ie: 



|8|4|2|1 I 

iTjTiTM I 



%1111 = 15 = $f 



So by dividing our binary number into a series 
of 4 bit segments we can work out our hex 
value ie: 182 in binary is %101 10110, separate 
into 4 bit segments: 1011 & 0110 and then 
convert these 4 bit segments bacl< to Hex ($0 - 
$F) which gives $B6. 

This may seem rather long winded (IT IS!!) but 
you'll soon be able to do numbers like that in 
your head, and as you'll find out at the end of 
this lession there is a REALLY EASY way to do 
this stuff :) Ok now lets convert from 
hexidecimal to decimal Its basically the same 
process in reverse. 

PROB: Convert the number $FA in hexidecimal 
to decimal. 

ANSWER: First convert the Hex value to binary 
So $FA splits into 2 lots of 4 bits %1 1 1 1 & 
%1010. 

Now convert this 8 bit number to decimal Ie: 



128 
1 


64 

1 


32 

1 


16 

1 


8 

1 


4 



2 
1 


1 




So $Fa=128+64+32+16+8+2=250. 

If you do bigger numbers and they don't split 
into even lots of 4 bit segments its no problem, 
just split them into 4 bit segments (allways 
starting at the right!!!) and work out your values 
then just work out your last value with whatever 
bits are left over ie: 

%1101011101 =>%11 0101 1101=>$35D 

So that's number systems, were now going to 
go into why we use these number systems, and 
I'm going to blither on about how this relates to 
last months article, but before I do remember I 
promised you a really easy way of working alt 
this out? 

Simply use the Calculator option in the Blitz2 
compiler menu this will allow to enter a number 
in any base (jsut prefix it with % or $ if its binary 
or hex) click on the number system you want 
the answer to and Voila there is your answer, 
now before you lynch me for boring you to 



death with stuff you didn't need to know, YOU 
DO NEED TO KNOW THIS, next month when 
we stop all this boring theory and get into some 
actual BLITZING you will know why until 

then <puts on best Arnold Schwartznegger 

volce> 'TRUST ME' 

Last month I did a paragraph about signed and 
unsigned numbers and ended up just telling 
you to believe me. I'm now going to show you 
why variables only hold up to certain numbers 
and why. THIS is one of the reasons why 
understanding number systems is necessary to 
understand programming. First a quick recap, if 
you remember there are 3 basic types of sizes 
a compter understands (blitz adds a few of its 
own but they are still based on these three 
types, they are.) 

.b=BYTE=8bits 
.w=W0RD=16bits 
.l=LONG=32 bits 

Now last month I said a unsigned BYTE can 
hold from to 255 THIS is why 

0=%00000000->Smallest value 8 bits can hold 
255=%1 1111111 ->Largest value 

Now if we use SIGNED BYTES the computer 
needs a way of telling if the values is positive 
or negative, it does this by setting the most 
significant bit (thats techie talk for the one on 
the extreme left) to on if the valueis NEGATIVE 

THIS MEANS, that the maximum value you 
can store is HALVED because that top bit is no 
longer available for your number and as you 
know every bit you add to a number doubles its 
capacity so taking one away halves it so as an 
example here are the answers to a binary 
value for a UNSIGNED and SIGNED byte 
% 10000001 as a unsigned byte equals 129 
%10000001 as a signed byte equals -1 

So now you see why in a byte you can 
represent either UNSIGNED - 255 or 
SIGNED -128 to +128 The same is true for 
word and long word values I wont demonstrate 
them, but it is the case. Well that's it for 
another month, next month we do a tiny bit of 
theory on truth tables, and then get into basic 
programme flow control and into some REAL 
PROGRAMME WRITING. Until then, keep on 
hammering away yourselves, and if you write 
something then SEND IT OVER THE WATER 
to us here in NZ. 

ROGER 
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"~~~~ 




$00 


HOOOOOOOO $40 64 @) 


H01000000 $80 126 


HI 0000000 $C0 192 A H1 1000000 






$01 


1 H00000001 $41 65 A 


H01000001 $81 129 


H10000001 $ci 193 A H1 1000001 






$02 


2 H00000010 $42 66 B 


H01000010 $82 130 


H10000010 $C2 194 A H1 1000010 






$03 


3 H00000011 $43 67 C 


H01000011 $63 131 


H10000011 $C3 195 A H1 1000011 






$04 


4 H00000100 $44 68 


H01000100 $64 132 


H10000100 $C4 196 A H1 1000100 






$05 


5 H00000101 $45 69 E 


H01000101 $85 133 


H10000101 $C5 197 A H1 1000101 






$06 


6 H00000110 $46 70 F 


H01000110 $86 134 


H10000110 $C6 198 >EH11000110 






$07 


7 H00000111 $47 71 G 


H01000111 $87 135 


H10000111 $C7 199 C H1 10001 11 






$06 


6 H00001000 $46 72 H 


H01001000 $86 136 


H10001000 $C8 200 E H1 1001000 






$09 


9 H00001001 $49 73 1 


H01001001 $89 137 


H10001001 $C9 201 E H1 1001001 






$0A 


10 H00001010 $4A 74 J 


H01001010 $8A 136 


H10001010 $CA 202 H1 1001010 






$0B 


11 H00001011 $4B 75 K 


H01001011 $8B 139 


H10001011 $CB 203 I H1 1001011 






$0C 


12 H00001100 $4C 76 L 


H01001100 $6C 140 


H10001100 $CC 204 H1 1001 100 






$0D 


13 H00001101 $40 77 M 


H01001101 $60 141 


H10001101 $CD 205 H1 1001 101 






$0E 


14 H00001110 $4E 76 N 


H01001110 $8E 142 


H10001110 $CE 206 H1 1001 110 






•l^- 


■}i ^§im-m-^-?- 


•M^ m-m- 


MQPOI.111. iaCE..2Q7...1...M»J.lflQ1.1.l1 

H10010000 $00 206 H1 1010000 
H10010001 $D1 209 N H1 1010001 






$11 


17 H00010001 $51 81 Q 


H01010001 $91 145 






$12 


18 H00010010 $52 82 R 


H01010010 $92 146 


H10010010 $02 210 6 H1 1010010 






$13 


19 H00010011 $53 83 8 


H01010011 $93 147 


H10010011 $D3 211 H1 1010011 






$14 


20 H00010100 $54 84 T 


H01010100 $94 148 


H10010100 $04 212 H1 1010100 






$15 


21 H00010101 $55 85 U 


HOI 01 01 01 $95 149 


H10010101 $D5 213 6 H1 1010101 






$16 


22 H00010110 $56 86 V 


H01010110 $96 150 


H10010110 $D6 214 6 H1 10101 10 






$17 


23 H00010111 $57 87 W 


H01010111 $97 151 


H10010111 $07 215 K H1 10101 11 






$18 


24 H00011000 $58 86 X 


H01011000 $98 152 


H10011000 $08 216 ^ H1 1011000 






$19 


25 H00011001 $59 69 Y 


HOI 01 1001 $99 153 


H10011001 $09 217 M H1 1011001 






$1A 


26 H00011010 $5A 90 Z 


HOI 01 1010 $9A 154 


H10011010 $0A 216 U H1 101 1010 






$1B 


27 H00011011 $5B 91 | 

28 H00011100 $5C 92 \ 


H01011011 $9B 155 


H10011011 $0B 219 U H1 1011011 






$1C 


H01011100 $9C 156 


H10011100 $0C 220 U H1 101 1100 






$1D 


29 H00011101 $50 93 | 


H01011101 $90 157 


H10011101 $00 221 H1 101 1101 






$1E 


30 H00011110 $5E 94 " 


H01011110 $9E 158 


H10011110 $0E 222 » H1 101 11 10 






■m 


31 H00011111 $5F 95 

•55f ■.J«5Td6»(J""'ISj"96"-^" 


H01011111 i 


(9F 159 


H10011111 iDF 2231 J H1 1011111 






"mxr6ixf66 iy^s'-vw" 


W16f66d(J5 $E0 224 i HIIIOOOOO 






$21 


33 i H00100001 $61 97 a 


HO1 100001 $A1 161 


i H10100001 $E1 225 A H1 1100001 






$22 


34 " H00100010 $62 96 b 


HO1 100010 $A2 162 


f H10100010 $E2 226 « H11100010 






$23 


35 # H00100011 $63 99 c 


HO1 100011 $A3 163 


C H10100011 $E3 227 ft H1 1100011 






$24 


36 $ H00100100 $64 100 d 


HO1 100100 


SA4 164 


B H10100100 $E4 228 A HI 1100100 






$25 


37 H H00100101 $65 101 e 


HO1 100101 


(A5 165 


V H10100101 $E5 229 ft H1 1100101 






$26 


38 & H00100110 $66 102 f 


HO1 1001 10 


(A6 166 


1 H10100110 $E6 230 n H1 11001 10 

1 H10100111 $E7 231 C H1 11001 11 

H10101000 $E8 232 ft H1 1101000 






$27 


39 ' H00100111 $67 103 g 

40 ( H00101000 $66 104 h 


HO1 1001 11 


(A7 167 






$26 


HO1 101000 


SA8 168 






$29 


41 ) H00101001 $69 105 1 


HO1 101001 


(A9 169 


©H10101001 $E9 233 ft H1 11 01 001 






$2A 


42 * H00101010 $6A 106 1 

43 * H00101011 $6B 107 k 


HO1 101010 


(AA 170 


« H10101010 $EA 234 6 H11101010 






$2B 


H01101011 


(AB 171 


* H10101011 $EB 235 ft HI 1101011 






$2C 


44 , H00101100 $6C 108 1 


H01101100 


(AC 172 


H10101100 $EC 236 \ HI 1101 100 






$20 


45 • H00101101 $60 109 m 


H01101101 


(AO 173 


- H10101101 $E0 237 f H1 1101 101 






$2E 


46 . H00101110 $6E 110 n 


H01101110 


lAE 174 


^HIOIOIllO $EE 238 f HI 1101 110 








47 / H00101111 $6F 111 


H01101111 


5AF 175 


H10101111 SEF 239 1 HlUQlltl 






'•m\VitXi66 iKJ "Tt8' 


* W1dfi6dd5 $F0 240 a Hinioooo 






$31 


49 1 H001 10001 $71 113 q 


H01110001 


(B1 177 


± H101 10001 $F1 241 ft H1 11 10001 






$32 


50 2 H001 10010 $72 114 r 


H01110010 


(B2 176 


« H101 10010 $F2 242 6 H1 11 10010 






$33 


51 3 H001 10011 $73 115 8 


H01110011 


(B3 179 


» HlOl 10011 $F3 243 6 H1 11 10011 






$34 


52 4 H001 10100 $74 116 t 


H01110100 , 


(B4 160 


H101 10100 $F4 244 6 H1 11 10100 






$35 


53 5 H001 10101 $75 117 u 


H01110101 , 


(B5 161 


p H10110101 $F5 245 6 H11110101 
! H10110110 $F6 246 6 H11110110 






$36 


54 6 H00110110 $76 118 V 


HO1 1101 10 $B6 182 






$37 


55 7 H00110111 $77 119 w 


H01110111 . 


(B7 163 


• H10110111 $F7 247 * H11110111 






$38 


56 8 H001 11000 $78 120 X 


HO1 11 1000 $B8 184 


H101 11000 $F8 246 a H1 11 11000 






$39 


57 9 H001 11001 $79 121 y 


HO1 11 1001 $B9 185 


' H101 11001 $F9 249 U H1 11 11001 






$3A 


58 : H001 11010 $7A 122 2 


H01111010 $BA 186 


« H101 11010 $FA 250 u H1 11 11010 






$3B 


59 ; H00111011 $7B 123 ( 

60 < H00111100 $7C 124 \ 


H01111011 


IBB 187 


» H10111011 $FB 251 H11111011 






$3C 


H01111100 


(BC 188 


V4HIOIIIIOO $FC 252 HI 11 11 100 






$30 


61 = H00111101 $70 125 ) 


H01111101 


%BD 169 


'/iHIOnilOl $FD 253 H11111101 






$3E 


62 > H00111110 $7E 126 - 


H01111110 


IBE 190 


HH10111110 $FE 254 b H11111110 
i H10111111 $FF 255 9 H11111111 






$3F 


63 7 H00111111 $7F 127 


H01111111 


(BF 191 




























$100 256 H0001 0000 0000 
$200 512 H0010 0000 0000 
$300 768 H001 10000 0000 
$400 1024 H0100 0000 0000 
$500 1260 HOI 01 0000 0000 
$600 1 536 HO1 10 0000 0000 
$700 1792 HO1 11 00000000 
$800 2048 H1000 0000 0000 
$900 2304 H1001 0000 0000 
$A00 2560 H1010 0000 0000 
$B00 2816 H101 10000 0000 
$C00 3072 H1 1 00 0000 0000 
$000 3328 H1 101 0000 0000 
$E00 3584 H1 1 10 0000 0000 






$1000 
$2000 
$3000 
$4000 
$5000 
$6000 
$7000 
$8000 
$9000 
$A000 
$B000 
$C000 
$0000 
$E000 


4096 HOOOl 0000 0000 0000 1 
61 92 HOOl 0000 0000 0000 
1 2288 HOOl 1 0000 0000 0000 
16384 %W100 0000 0000 0000 
20480 H0101 0000 0000 0000 
24576 H0 1 1 0000 0000 0000 
28672 HOI 1 1 0000 0000 0000 
32766 HI 000 0000 0000 0000 
36864 HI 00 1 0000 0000 0000 
40960 HI 01 0000 0000 0000 
45056 HI 01 1 0000 0000 0000 
49152 HI 100 0000 0000 0000 
53248 HI 101 0000 0000 0000 
57344 H1 1 1 0000 0000 0000 








$F00 3840 H11 11 0000 0000 






$F000 


61 440 H1 1 1 1 0000 0000 0000 














S PAGE WAS GBIERATED and PAGESET IN 12 liNUT 
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ESIS/r 


non 



Due to severe time mis-management example code and explanations that make any sense of 
the following commands have had to be delayed until next issue (yeh sure Simon). 

Some examples have been Included In the examples drawer of BUMS's cover disk. Also 
source code to the new GadTools and Display libraries have been included in the libsdev 
drawer for those capable of making any sense of them. 

Window Library Additions 
Statement: Window 



Syntax: Window Windbw^,x,y,width,heightM9s,mie$,dpen,bpenl,gadgetlisW^^^^ 

The Window library has been extended to handle super bitmap windows. SuperBitMap 
windows allow the window to have it's own bitmap which can actually be larger than the 
window. The two main benefits of this feature are the window's ability to refresh Itself and the 
ability to scroll around a large area "inside" the bitmap. 

To attach a BitMap to a Window set the SuperBitMap flag in the flags field and include the 
BitMap# to be attached. 

Statement: PositionSuperBitMap 



Syntax: PositionSuperBitMap x,y 

PositionSuperBitMap is used to display a certain area of the bitmap in a super bitmap window. 

Example: 

; 

; super bitmap example 
\ 

fcreete large bimtap for our superbiimap window 

wlGlths320:helghU200 BitMap 0.wiGlth.hei8ht.2: 
Circlef 160J00,160.100.1:Box0.0.wJdlh-1.heigW-1,3 

FindScreen 

jtwo sliders tor the borders Csee new gadget flags next page) 

PropGadget 0.3,-8, 118000^4^8+64,1.-20,8 
PropGadgel0,-14,10,$11000+2+16+128.2.12,-20 

;reporting of mousennov/es means we can track the propgadget as it is moved 

AddDCMP 110 

SizeLlroits32,32,widthf22.heightf20 
Window 0,0,0.100,100.I1488.''HELLOM.2.0.0 
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Gosub drawsuper 

Repeat 

ev.UWaitEvent 

If ev=2 Then Gosub dosize 

If evsl20 Then Gosub domove 
Until ev=f 200 
End 

dosize: 

SetHPropO.l.posx/width.lnnerWidlWwidth 
SetVPropO,2.posy/height.lnnerHeJahWheight 
Redraw 0,1:Redraw 0,2:Goto drawsuper 

domove: 

Repeat:Gosub drawsupenUntil WaitEvenU>$10:Retum 

drawsuper: 

ww=width-lnnerWidlh:hh=height-hnerHelaht 

posx=QLimJlCHPropPotC0,1>Cww+1),0.ww3 

posy=QLinnilCVPropPotC0.2Khh+1),0.hh) 

PosiHonSuperBitMap posx.posy 

Return 

Statement: GetSuperBitMap & PutSuperBitMap 

Syntax: GetSuperBitMap & PutSuperBitMap 

After rendering changes to a superbltmap window thebitmap attached can also be updated 
with the GetSuperBitMap. After rendering changes to a bitmap the superbitmap window can 
be refreshed with the PutSuperBitMap command. Both commands work with the currently 
used window. 

Statement: WTitle 

Syntax: WTitle winclowtitle$,screentitle$ 

WTitle is used to alter both the current window's title bar and it's screens title bar. Useful for 
displaying important stats such as program status etc. 

Statement: Close Window 

Syntax: CloseWindow Window^ 

CloseWindow has been added for convenience. Same as Free Window but a little more 
intuitive (added for those that have complained about such matters). 



Statement: WPrintScroll 



Syntax: WPrintScroll 
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WPrintScroll will scroll the current window upwards If the text cursor Is below the bottom of 
the window and adjust the cursor accordingly. Presently WPrintScroll only works with 
windows opened with the gImmeOO flag set (#glmme2ero2ero=$400). 

Statement: WBlit 



Syntax: WBlit Shape^xy 

WBlit can be used to bllt any shape to the current window. Completely system friendly this 
command will completely clip the shape to fit Inside the visible part of the window. Use 
GImmeZeroZero windows for clean clipping when the window has title/sizing gadgets. 

Statement: BitMapto Window 

Syntax: BitMaptoWindow Bitmap^,Window^[,srcx,srcy,destx,desty,wid,height] 

BitMaptoWindow will copy a bitmap to a window In an operating system friendly manner 
(what do you expect). The main use of such a command Is for programs which use the raw 
bitmap commands such as the 2D and Bllt libraries for rendering bitmaps quickly but require a 
windowing environment for the user inyerface. 

Functions: EventCode & EventQualifier 



Syntax: EventCode & EventQualifier 

EventCode returns the actual code of the last Event received by your program, 
EventQualifier returns the contents of the Qualifier field. Of use with the new GadTools library 
and some other low level event handling requirements. 



Gadget Library Additions 

Five new flags have been added when defining gadgets In Blltz2. The first four are for 
attaching the gadget to one of the windows borders, the GZZGADGET flag is for attaching the 
gadget to the "outer" rastport/ layer of a gimme zero zero window. 

#RIGHTBORDER $1000 

#LEnBORDER $2000 

#TOPBORDER $4000 

#BOTTOI^BORDER $8000 

#GZZGADGET $10000 

PropGadgets have been upgraded to take advantage of the 2.0 "newlook" when/if available. 

Statement: Toggle 

Syntax: Toggle GadgetUst^,ld [,On I Off] 

The Togggle command in the gadget library has been extended so it will actually toggle a 
gadgets status If the no On | Off parameter is missing. 
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Screen Library Additions 
Statement: CloseScreen 



Syntax: CloseScreen Screen^ 

CloseScreen has been added for convenience. Same as Free Screen but a little more 
intuitive (especially for those that have complained about such matters (yes we care)). 

Statement: HideScreen 



Syntax: HideScreen Screen^ 

Move Screen to back of all Screens open in the system. 

Statement: BeepScreen 

Syntax: BeepScreen Screen^ 
Rash specified screen. 

Statement: MoveScreen 



Syntax: MoveScreen Screen^,deltax,deltay 

Move specified screen by specified amount. Good for system friendly special effects. 

Statement: ScreenTags 

Syntax: ScreenTags Screen^, Titles [ATagList] or[[, Tag,Data]...] 

Full access to all the Amiga's new display resoutlons is now available In Amiga mode by use 
of the Screen Tags command. The following tags are of most interest to Blitz2 programmers: 
(see autodocs/ 

#Left=$80000021:#Top=$80000022:#Wldth=$80000023:#Height=$80000024 

#Depth=$80000025:#DetailPen=$80000026:# BlockPen=$80000027 

#Title=$80000028:#Colors=$80000029:#ErrorCode=$8000002A 

#Font=$8000002B:#SysFont=$8000002C:#Type=$8000002D:#BitMap=$8000002E 

#PubName=$8000002F:#PubSig=$80000030:#PubTask=$80000031 

#DlsplaylD=$80000032:#DCIIp=$80000033:#Overscan=$80000034 

#Obsolete 1 =$80000035 

#ShowTitle=$80000036:#Behind=$80000037:# Quiet=$80000038 
#AutoScroll=$80000039:#Pens=$8000003A:#FullPalette=$8000003B 
#ColorMapEntries=$8000003C:#Parent=$8000003D:#Draggable=$8000003E 
#Exclusive=$8000003F 
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#SharePens=$80000040:#BackFili^80000041 :# lnterieaved=$80000042 
#Colors32=$80000043:#VideoControl=$80000044 
#FrontChild=$80000045:#BackChild=$80000046 
#UkeWorkbench=$80000047:#Reserved=$80000048 

open super wide screen with overscan set for smoot/i horizontal scroll 
for 2.0 and above with amigalibs.res in resident 

ii3ilMap=$8000002E:i.Overscan=$80000034:».Width=l80000023:«JHeighU$80000024 
BUMap 0.1280.512.2:Circlef 320.256.256.1 

ScreenTaas0,"TEST".i.BilMap.AddrB«MapC0).i».Overscan.1.».WIcllh.640.a.Heiaht.512 
•vp.VJewPortsViewPortCO) 

While JoybCO)»0 

VWait 

*vp^DxOffseU-SMouseX.-SMouseY 

ScrollVPort. *vp 
Wend 

Palette Library Additions 

The Palette library has been modified in BUMS for two reasons. Firstly, it was impossible to 
perform custom fades using two palettes as the Use Palette command affected the current 
Slice or Screen. Also with the advent of the Display library the extra properties of the Use 
Palette command (copy colors to current Slice or Screen) became unwanted. 

The ShowPalette command has been added to replace the above functionality removed from 
the Use Palette command. Also, for compatability reasons NewPaletteMode On is used for 
enabling the above modifications (default is off). 



Statement: ShowPalette 



Syntax: ShowPalette Palette^ 

ShowPalette replaces Use Palette for copying a palette's colours to the current Screen or 
Slice. 



Statement: NewPaletteMode 



Syntax: NewPaletteMode On /Off 

The NewPaletteMode flag has been added for compatibility with older Blitz2 programs. By 
setting NewPaletteMode to On the Use Palette command merely makes the specified palette 
the current object and does not try to copy the colour information to the current Screen or 
Slice. 
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MISC ADDITIONS 
Statement: SortList 

Syntax: SortList ArraynameQ 

The SortList command is used to rearrange the order of elements in a Biitz2 linked list. The 
order In which the Items are sorted depends on the first field of the linked list type which must 
be a single integer word. Sorting criteria will be extended in future releases. 

Statement: LoadFont 

Syntax: LoadFont lntuiFonW,Fontname.font$,Y size istyle] 

The LoadFont command has been extended with an optional style parameter. The following 
constants may be combined: 

#underlined=1 

#bold=2 

#itallc=4 

#extended=8 ;wlder than normal 

#colour=64 ;hmm use colour version I suppose 



Statement: SpriteMode 



Syntax: SpriteMode mode 

For use with the capabilities of the new Display library SpriteMode is used to define the width 
of sprites to be used in the program. The mode values 0, 1 and 2 correspong to the widths 16, 
32 and 64. 



Function: Exists 



Syntax: Exists (FileName$) 

Exists actually returns the length of the file, if the file either does not exist or is empty or is 
perhaps not a file at all! Hmmm, anyway the following poke turns off the "Please Insert Volume 
Blah:** requester so you can use Exists to wait for disk changes: 

Poke.lPeek.iCPeek.lC4)f276)f 184.-1 

Statements: Runerrson & Rimerrsoff 

Syntax: Runerrson & Runerrsoff 

These two new compiler directives are for enabling and disabling error checking in different 
parts of the program, they oven^ide the settings in Compiler Options. 
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The New Display Library 
(#displayiib=143) 

The new display library is an alternative to the slice library. Instead of extending the slice 
library for AG A support a completely new display library has been developed. 

Besides support for extended sprites, super hires scrolling and 8 bitplane displays a more 
modular method of creating displays has been implemented with the use of CopLists. CopLists 
need only be initialised once at the start of the program. Displays can then be created using 
any combination of CopLists and most importantly the CreateDisplay command does not 
allocate any memory avoiding any memory fragmenting problems. The new display library is 
for non-AGA displays also. 

Statement: InitCopList 

Syntax: InitCopList CopUsW,ypos,height,type,sprites,colors,customs[,widthadjust] 

InitCopList is used to create a CopLlst for use with the CreateDisplay command. The ypos, 
height parameters define the section of screen. Sprites, colors and customs will allocate 
instructions for that many sprites (always=8!) colors (yes, as many as 2561) and custom 
copper instructions (to be used by the new DisplayFX library currently In devlopment). 

The widthadjust parameter is currently not implemented, for display widths other than standard 
see the DisplayAdjust command. The following constants make up the type parameter, add 
the number of bitplanes to the total to make up the type parameter. 

#smoothscroll=$1 #dualplayfield=$20 #extrahalfbrite=$40 #ham=$80 

#lores=$000 #hires=$100 #super=$200 

#loressprites=$400 #hiressprltes=$800 #supersprites=$cOO 

#fmodeO=$0000 #fmode1=$1000 #fmode2=$2000 #fmode3=$3000 

For displays on non-AGA machines only #fmodeO and #loressprites are allowed. More 
documentation, examples and fixes will be published soon for creating displays. 

Statement: CreateDisplay 

Syntax: CreateDisplay CopLisW[,CopList^..] 

CreateDisplay is used to setup a new screen display with the new display library. Any number 
of CopLists can be passed to CreateDisplay although at present they must be in order of 
vertical position and not overlap. CreateDisplay then links the CopLists together using internal 
pointers, bitmaps, colours and sprites attached to coplists are not affected. 

Statement: DispIayBitM ap 



Syntax: DisplayBitMap CopUst^,bmapl,x,y] [,bmap[,x,y]] 

The DisplayBitMap command is similar in usage to the slice libraries' show commands. 
Instead of different commands for front and back playfields and smooth scroll options there is 
only the one DisplayBitMap command with various parameter options. With AGA machines, 
the X positioning of lores and hires coplists uses the fractional part of the x parameter for super 
smooth scrolling.The CopList must be initialised with the smooth scrolling flag set If the x,y 
parameters are used, same goes for dualplayfield. 
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Statement: DisplaySprite 



Syntax: DisplaySprite CopUsW,Sprite^,XXSprite Channel 

DisplaySprite Is similar to the slice libraries ShowSprlte command with the added advantage of 
super hires positioning and extra wide sprite handling. See also SpriteMode. 



Statement: DisplayPalette 



Syntax: DisplayPalette CopUst^,Pal0tte^ [.coloroffset] 

DisplayPalette copies colour Information from a Palette to the CopList specified. 



Statement: DisplayControls 



Syntax: DisplayControls CopUst0,BPLCON2,BPLCON3,BPLCON4 

DisplayControls allows access to the more remote options available in the Amiga's display 
system. The following are the most Important bits from these registers (still unpublished by 
Commodore!*()@GYU&") 





BPLCON2 


BPLCON3 


BPLCON4 


15 


* 




BANK2 "active colour bank 


BPLAM7 xor with bitplane 
BPLAM6 DMA for altering 


14 


ZDBPSEL? 


which bitplane forZD 


BANK1 * 


13 


ZDBPSEL1 




BANKO • 


BPLAM5 effective colour 


12 


ZDBPSELO 




PF20F2 col-offset for playfieki 2 


BPlAMAIookup 


11 


ZDBPEN 


makes above bp hit ZD 


PF20F1 


BPLAM3 


10 


ZDCTEN 


ZD is bit^lS of colour 


PF2OF0 


BPLAM2 


09 


KILLEHB 


* 


LOCT 'palette hi/lo nibble mode 


BPLAM1 


08 


RDRAM=0 


* 




BPLAMO 


07 


SOGEN 


1 sync on green 


SPRES1 * sprites resolution 


ESPRM7 high order color 
ESPPM6 offset for even 


06 


PF2PRI 


Hplayfield 1/2 priority 


SPRESO* 


05 


PF2P2 


H pfayfie/d/sprite priority 


BRDRBLANK border is black 


ESPF^S sprites 


04 


PF2P1 




BRDNTRAN border hits ZD 


ESPRM4 


03 


PF1P0 






OSPPM7 high order color 
OSPPMB offset for odd 


0? 


PF1P2 




ZDCLCKEN ZD==14Mhzclock 


01 


PFIPt 




BRDSPRT sprites in bordersi 


OSPRMS sprites 


00 


PF1P0 




EXTBLKEN wo blank outpuH 


OSPRM4 



! = Don't touch 

H -See standard hardware reference manual 

* ' controlled by display Khrary 

ZD - any reference to ZD Is only a guess Oust sold my genlock) 



Statement: Display Adjust 



Syntax: DisplayAdjust CopUst0Jetchwid,ddfstrt,ddfstop,diwstrt,diwstop 

Temporary control of display registers until I get the widthadjust parameter working with 
InltCopUst. Currently only standard width displays are available but you can modify the width 
manually (just stick a screwdriver In the back of your 1084) or with some knowledge of 
Commodores AGA circuitry. 

Anyway, before I start going on about why they couldn't just give us byte per pixel instead of 8 
dam bitplanes (CD32 to the rescue!) see the cover disk for more infonnation... 
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The New ASL Library 
(#myasllib=80) 



Our policy until now has been that we would only place emphasis on 1.3 compatible 
commands unless of course they had to do with AGA. Then again I don't even have a 
LoadWB in my startup-sequence! So instead of complaining I spent an uncomfortable week 
adding the following 2.0 above specific commands to Blitz2. 

And as for those with 1 .3 and want new ROMS? BURN BABY BURN... 

Function: ASLFileRequest$ 

Syntax: ASLFileRequestS (Title$,Pathname$,Filename$ [,Pattem$] [,x,y, w,h]) 

The ASL File Requester is nice. Except for the highlight bar being Invisible on directories you 
get to use keyboard for everything, stick in a patterns to hide certain files and of course you 
get what ever size you want. I made it call the Blitz2 file requester if the program is running 
under 1.3 (isn't that nice!). There is a fix that patches the ReqTools file requester but that 
doesn't have the date field. 

I couldn't get the Save-Only tag or the "Create Directory" option working maybe next upgrade. 

MaxLen pals 192 
MaxLenfi$=192 

FindScreen 

fl=ASLFileReqyeslinest".pal.fil."»?.bb».0.0.640.256D 

IffI 

NPrint \% 
Else 

NPrinl "failed" 
Endtf 

MouseWait 

Function: ASLFontRequest 

Syntax: ASLFontRequest (enable flags) 

The ASL Font Requester is also pretty useful. The flags parameter enables the user to modify 
the following options: 

#pen=1 :#bckgrnd=2:#style=4:#drawmode=8:#fixsize=1 6 

It doesn't seem to handle colour fonts, no keyboard shortcuts so perhaps patching ReqTools 
is an option for this one. The following code illustrates how a .fontinfo structure is created by a 
call to ASLFontRequest Qust like programming in a high level language man!). 

Example: 
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NEWTYPE .fontinfo 

naime.s 

ysize.w 

style.brfiags.b 

pen1.b:pen2:drawmode:pad 
End NEWTYPE 

FindScreen 

*^fonlinfo=ASLFonlRequeslC15) 

lf*f 

NPrlnl»hnanne 

Wrinl »hysize 

NPrinMhpenI 

NPrinl *f\pen2 

NPrinl «ndrawnnode 
Else 

NPrinrcancelled" 
Endlf 



MouseWait 

Function: ASLScreenRequest 



Syntax: ASLScreenRequest (enable flags) 

Those who are just getting to grips with 2.0 and above will find this command makes your 
programs look really good, however I haven't got time to explain the difficulties of developing 
programs that work In all screen resolutions (what are ya?). 

#wldth= 1 :#height=2:#depth=4:#overscan=8:#scroll=1 6 

NEWTYPE .screeninfo 

Id.l 

width.! 

height.l 

depth .w 

overscan.w 

autoscroil.w 

bimap width.! 

bimapheight.! 
Er»d NEWTYPE 

FindScreen 

»sc.screemnfo=ASLScreenRequestC31) 

lf»sc 

NPrint *sc\width.'' ".»scmelaht." "/scWepth 
Else 

NPrint "cancelled" 
Endlf 
MouseWait 
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The New GadTools Library 
(#mygadtoolslib=141) 

GadTools is a 2.0 and greater extension to the operating system that gives the Amiga 
programmer a few extra enhancements to create juicy user interfaces with. Instead of listing 
each as a separate command this issue I'll just add a brief description and a relevant taglist 
to each of the 12 gadgets. 

You are allowed both standard gadgets and GadTools ones in the same window, of course 
id clashes must be avoided and unlike standard gadgets, gadtoois gadgets are attached to 
the Window after it is open with the AttachGTUst command. 

GTButton GTUst^Mx,y,w,hJext$,fla9S 

Same as Blitz2's TextGadget but with the added flexibility of placing the label Text$ above, 
below to the left or right of the button (see flags). 

GTCheckBox GTUsW,id,x,y,w,hJext$,flags 

A box with a check mark that toggles on and off, best used for options that are either 
enabled or disabled. 

GTCycle GTUst#,id,x,y,w,h, Texts, flags, Options$ 

Used for offering the user a range of options, the options string should be a list of options 
separated by the | character eg. "HIRES ) LORES } SUPER HIRES" 

GTInteger GTUst^,id,x,y,w,h, Text$,flags,de fault 

A string gadget that allows only numbers to be entered by the user. 

GTListView GTUst#,id,x,y,w,fi, Text$, flags, listQ 

The ListView gadget enaables the user to scroll through a list of options. These options 
must be contained in a string field of a Blitz2 linked list. Currently this string field must be 
the second field, the first being a word type. 

GTMX GTList^,id,x,y,w,t),Text$,flags,Options$ 

GTMX is an exclusive selection gadget , the Options$ is the same as GTCycle in format, 
GadTools then displays all the options in a vertical list each with a hi-light beside them. 

GTNumber GTList0,id,x,y,w,t),Text$,flags,value 

This is a readonly gadget (user cannot interact with it) used to display numbers. 

GTPalette GTList^,id,x,y, w,t), Text$,flags,deptti 

Creates a number of coloured boxes relating to a colour palette, 

GTScroller G TUst^,id,x,y, w,h, Text$, flags. Visible, Total 

A prop type gadget for the user to control an amount or level, is accompanied by a set of 
arrow gadgets. 
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GTSIider GTUst0Mx,y,w,hJe)ct$,fla9sMn,Max 

Same as Scroller but for controlling the position of display inside a larger view. 

GTString GTLisWMKY, w»h, TextS, flags, MaxChars 

A standard string type gadget 

GTText GTUst^MKy,w,h,Text$,ffags,Display$ 

A read only gadget (see GTNumber) for displaying text messages. 

The parameters x.y,w,h refer to the gadgets position and size, the Text$ is the label as 
referred to above. The flags field is made up of the following fields: 

# LEFT==1 ;positionlng of the optional gadget label Text$ 
#"RIGHT=2 

# AB0VE=4 
#"BEL0W=8 
#:iN=$10 

#_Hlgh=$20 ;Wghlight 
#_Disable=$40 ;turned off 
#_fmmediate=$80 ;activate on gadgetdown 
#_BoolValue=$100 ;checkbox on 
#_Scaled=$200 ;scale arrows for slider 
#_Vertical=$400 ;make slider/scroller vertical j 

Statement: AttachGTList 

Syntax: AttachGTList GTL/st^, Window^ \ 

The AttchGTList command is used to attach a set of GadTools gadgets to a Window i 

after it has been opened. j 



Statement: GTTags 



Syntax: GTTags Tag, Value [, Tag, Value...] 

The GTTags command can be used prior to initialisation of any of the 12 gadtools 
gadgets to preset any relevant Tag fields. The following are some useful Tags that can 
be used with GTTags: 

ttagxlaOOSOOOO 

•GTCB.Checkeclsttagf4 ; State of checkbox 
•GTLV.Topsatag^S ; Top visible Item in listview 

•GILV^ReadOnlysataof 7 ; Set TRUE if listview is to be Readonly 
•GTMX.Active«ataa«10 ; Active one in mx gadget 
•GTTX.Text.atagf 11 ; Text to display 
•QTNM.Nuniberzttag4l3 ; Number to display 
•GTCY.Active3»tagf15 ; The active one In the cycle gad 
•GTPA.Cotorsatag-^ 17 ; Palette color 
tGTPA.ColorOffset«atag«18 ; Rrst color to use in palette 
•GTSC.Top8ttagf21 ; Top visible in scroller 
•GTSC.TotaUttagf22 i Total in scroller area 
•GTSC.Visibte«atag^23 ; Number visible in scroller 
•GTSL.LeveUatag440 } Slider level 
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iGTSLJu<a>(Ley/elLenstt&g441 ; Max length of printed level 
•GTSLJ-evelFofmat=:«lag+42 ;* Format string for level 
iGTSL J.evelPlaces»tagf 43 ;* Where level should be placed 
ttGTLV_Selected=atagi54 ; Set ordinal number of selected 
aGTMKlSpacingsitagf 61 ;* Added to font height to 

All of the above except for those marked * can be set after initialisation of the Gadget using the 
GTSetAttrs confimand. The following is an example of creating a slider gadget with a numeric 
display: 

f$="%2ld'':GTTaga#GTSLLevelFormat,&f$,#GTSLMaxLevelLen,4 
GTSIider 2, 1 0,320. 1 20,200.20,"GTSUDER-,2,0, 1 



Function: GTGadPtr 



Syntax: GTGadPtr (GTUsWJd) 

GTGadPtr returns the actual location of the specified GadTools gadget in memory. 

Statement: GTBevelBox 

Syntax: GTBevelBox GTUst0,x,y,w,h,fiags 

GTBevelBox is the GadTools library equivalent of the Borders command and can be used to 
render frames and boxes in the currently used Window. 



Statement: GTChangeList 



Syntax: GTChangeList GTList^Jd [ .UstQ ] 

GTChangeList must be used whenever a List attached to a GTListView needs to be modified. 
Call GTChangeList without the List() parameter to free the List, modify it then reattache it with 
another call to GTChangeList this time using the List() parameter. 



Statement: GTSetAttrs 



Syntax: GTSetAttrs GTLisWJd lJag,Value...] 

GTSetAttrs can be used to modify the status of certain GadTools gadgets with the relevant Tags. 
See GTTags for more information on the use of T^gs with the GadTools library. 
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TITLE: 

RELEASE DATE: 
PUBLISHER: 
NUM TRACKS: 
VEHICLES: 
CUSTOMISED CARS: 
MODEM CONNECT: 
MAX PLAYERS: 
MINIMUM MEM 



SKIDMARKS 
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Acid Software 
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